小柒系列机器人帮助文档

文档版本：1.0.0-beta

请确定文档与你的机器人版本一致

tips：

1. 如果你是一个普通用户可以直接看：2.5.基础功能、2.6.RPG游戏、2.7.部落冲突查询。
2. 如果你只是一个群主/群管理，想要在群内好好使用小柒直接看：2.4.群内管理。
3. 如果你是一个租用了小柒机器人的机器人主人建议通篇阅读，以便于你更好的理解小柒机器人。
4. 如果你有疑问也可以直接参考：3.常见问题Q&A。或者加入官方Q群（479504567）询问。以上两种方法一定能帮助你解决问题，请不要暴躁或者直接使用粗鲁的手段对待小柒。

1.前言

在使用小柒之前这里有一些基础的知识需要你了解，当然如果你足够熟悉也可以跳过该部分。

1.1.基础知识

小柒是一个分布式的机器人系统，每个人都可以选择前往官方Q群（479504567）咨询如何搭建一个自己的小柒。

并且，小柒是一个公益性项目，百分百只回收运营成本即服务器的成本。个人开发成本以及时间消耗不算做成本之中。

每个机器人的名字并不一样，不是所有的机器人都叫做小柒。这是一系列的机器人。

1.2.权限架构

小柒的权限大概可以分为三个部分：系统权限、机器人权限、群内权限。

1. 系统权限：系统超级管理员、系统管理员、普通成员，拥有更改所有机器人的权限。只有系统超级管理员才可以任免系统管理员。

2. 机器人权限：

   1. 主人：可以任免管理员。可以管理黑名单。
   2. 管理员：就算不是一个群的管理员依然可以操作机器人。
   3. 普通成员。

3. 群内权限：

   1. 群主/管理员：可以操作机器人的群内权限。（例如休眠，开启/关闭游戏等）
   2. 普通成员。

2.指令

以下所有由方括号标记的字符都是可变参数，圆括号标记的字符是可选参数。可变参数根据实际情况自由选择，可选参数可以没有。

例如：

1. [机器人名字]，该命令用作唤醒机器人，这时候应该根据不同机器人的名字来不同选择。比如机器人叫做小柒就只需要发“小柒”这两个字唤醒即可。

2.1.基础指令

2.1.1.[机器人名字]

该指令可以唤醒小柒系列的机器人。是检测机器人是否还在线的最快捷的途径。

如果你在黑名单中，小柒仍然会理你。每天的第一次唤醒，小柒将会提醒你目前在黑名单中，这也是确定自己或本群是否在黑名单中的唯二途径之一。

2.1.2.机器人信息

该命令可以查看机器人的信息。在这里可以查看到机器人的基本信息

2.1.3.统计信息

该命令可以查看机器人的统计信息，主要是当天发送的消息数量。

2.1.4.我的权限

使用本命令可以查看当前你的权限，具体的权限分类可以在前言看到。

权限具体参考：1.2.权限架构

2.1.5.版本信息

小柒的版本号采用三位表示法：x.y.z[-alpha | -beta | -ma]

1. x变动为大框架的变动，例如：0.6.12升级到1.0.0这次版本就是一个大改动。

2. y表动为中变动，具体表现为单模块增删或重构。例如：0.3.9升级到0.4.1加入了文字RPG游戏。

3. z变动是一次小更新表动，特性修改、bug修复等。

4. [-alpha | -beta | -ma]为后缀，小柒版本号有三个后缀：

   1. alpha：例如版本1.0.0-alpha所有带有改后缀的版本号都表示内测，这是一个不公开的只会在生产环境测试的版本。
   2. beta：例如版本1.0.0-beta带有该后缀表示局部内测的版本。只会在部分群开放内测。
   3. ma：该后缀是系列后缀a表示任意整数。例如1.0.0-m1、1.0.0-m2。该后缀表示预览版，分别表示第一个预览版，第二个预览版。这种只会发生在两种情况，下个版本的一个新功能非常重要，但是其他功能还没有完善，紧急发布一个预览版。或者当前版本有重大bug，但是下个版本还没有制作完成。

使用本命令可以查看当前的版本。

2.1.6.全局模块列表

查看当前机器人主人开启了哪些模块，关闭了哪些模块。

2.1.7.模块列表

查看当前群内开放了哪些模块，关闭了哪些模块。

2.1.8.公约

查看当前小柒的服务公约。建议查看违背公约将会收回小柒的使用权。

2.1.9.查看背景任务

查看当前正常运行的背景任务个数。主要与定时任务等相关。

2.2.主人管理指令

主人可以使用管理员指令，也可以使用群管理指令，所有权限向下覆盖。

2.2.1.广播消息

该指令可以向当前小柒机器人加入的所有群内发送消息！！请谨慎使用。并且该指令发送将会占用大量的时间，如果加了大量的群。

2.2.2.授权码

该指令只有私聊可以生效，获取当前机器人的授权码。授权码请不要泄露给其他人！通过授权码可以登陆后台系统修改全局配置和开关机器人。如果授权码泄露请及时申请更改授权码。

2.2.3.开启自动添加好友

开启后机器人会自动通过好友申请

2.2.4.关闭自动添加好友

关闭机器人自动通过好友申请

2.2.5.开启自动添加群

开启后机器人会自动通过群申请

2.2.6.关闭自动添加群

关闭机器人自动通过群申请

2.2.7.同意好友请求 [事件id]

远程同意好友请求，事件id在订阅了新好友提醒后会发送到你的QQ上。

红框内的数字就是好友事件id。

2.2.8.拒绝好友请求 [事件id]

远程拒绝请求

2.2.9.同意群申请 [事件id]

远程同意群申请，事件id在订阅了新群提醒后会发送到你的QQ上。

id号可以参考：2.2.7.同意好友请求

2.2.10.拒绝群申请 [事件id]

远程拒绝请求

2.2.11.开启新好友提醒

开启后当有人申请好友的时候就会通知机器人主人。

参考：2.2.7.同意好友请求

2.2.12.关闭新好友提醒

关闭新好友提醒

2.2.13.开启新群提醒

注意：讨论组邀请是不需要同意的，小柒会直接加入目标群（如果拥有小柒好友的话），这是QQ机制，不受小柒控制。

开启后当有人邀请小柒加入群就会获得提醒。

2.2.14.关闭新群提醒

关闭新好友提醒

2.2.15.开启退群提醒

当小柒退出某个群的时候会有提醒

2.2.16.关闭退群提醒

关闭退群提醒

2.2.15.开启禁言提醒

当小柒在某个群被禁言的时候将会有提醒

2.2.16.关闭禁言提醒

关闭禁言提醒

2.2.17.开启心跳

开启心跳后，每隔心跳间隔的小时，小柒将会给主人发送一条信息，来通知其是否还活着，如果你没有按时收到消息，证明小柒很有可能运行异常。

2.2.18.关闭心跳

关闭心跳

2.2.19.设置心跳 [小时]

将心跳设置为某个小时。例如：设置心跳 5。请注意小时只能取1——24的整数。

2.2.20.设置机器人昵称 [昵称]

是否不喜欢小柒这个原始的名字呢？通过该命令可以修改机器人名字。

2.2.21.查看机器人管理员

查看当前有哪些管理员

2.2.22.添加机器人管理员 [qq号]

将目标QQ号对应的QQ添加为本机器人的管理员

2.2.23.删除机器人管理员 [qq号]

删除一个管理员

2.2.24.清除缓存

清除当前缓存的所有群和人。有可能会加速机器人，如果高并发清缓存也无法缓解。

2.3.机器人管理指令

管理员也可以在没有群管理的情况下使用2.4.群内管理的命令，权限向下覆盖。

2.3.1.查看黑名单人 [页码]

例如：查看黑名单人 1表示查看第一页的黑名单。省略数字默认查询第一页。

查看所有黑名单人

2.3.2.查看黑名单群 [页码]

查看所有黑名单群

2.3.2.添加黑名单人 [qq号] [理由]

例如：添加黑名单人 123456 测试一下黑名单

将一个人加入黑名单。理由与qq号都不可以省略。

2.3.3.删除黑名单人 [qq号]

删除一个人

2.3.2.添加黑名单群 [群号] [理由]

例如：添加黑名单群 123456 测试一下黑名单

将一个群加入黑名单。理由与qq号都不可以省略。

当一个群被拉入黑名单之后小柒将不会响应这整个群的消息，不论你是否在黑名单内，都无法通过这个群让小柒回复你，除非你的权限大于等于机器人管理员。

2.3.3.删除黑名单群 [群号]

删除一个人

2.4.群内管理

管理之前先参考：2.2.7.模块列表。该命令可以查看开关状态。

2.4.1.[@小柒] 退群

这是唯有的两条小柒在休眠状态也会回复的指令。

例如：@小柒 退群。具体需要艾特对应的机器人

如果你对小柒感到不满，或者你不需要该机器人，在征得其他人同意后，我们建议您使用该命令让小柒主动退群。

2.4.2.[@小柒] 休眠

让小柒休眠，请注意千万不要忘了小柒在休眠状态。 在休眠状态，小柒不会回复任何消息。

2.4.3.[@小柒] 解除休眠

让小柒从休眠状态醒来。

2.4.4.开启限制模式

如果群内有多个小柒系列的机器人的时候这是一个不错的功能。开启限制模式后。

只有艾特小柒的消息，小柒才会回复，其他消息都不会回复。

2.4.5.关闭限制模式

注意：关闭限制模式的时候，一定要艾特小柒，因为这时候小柒仍然是在限制模式下的

关闭限制模式

2.4.6.开启成员监控

开启后，群成员改名片、群成员加入退出等都会有提醒

2.4.7.关闭成员监控

关闭成员监控

2.4.8.开启解除闪照

只要群内有人发闪照，小柒就可以将其破解QWQ。

2.4.9.关闭解除闪照

关闭解除闪照

2.4.10.开启防撤回

开启防撤回，开启后群成员撤回消息，小柒将会复述。

2.4.11.关闭防撤回

关闭防撤回

2.4.12.开启戳一戳

开启戳一戳。不妨开启后双击小柒的头像试试，你就知道会发生什么了。

2.4.13.关闭戳一戳

关闭戳一戳

2.4.14.开启自定义回复

开启自定义回复后就可以自定义一些群内的回复内容。

2.4.15.关闭自定义回复

关闭自定义回复。

2.4.16.开启自动加一

开启自动加一后，两条一样的话，小柒将会自动加一。

2.4.17.关闭自动加一

关闭自动加一

2.4.18.开启部落冲突查询

只有开启后才可以使用2.7.部落冲突查询。

2.4.19.关闭部落冲突查询

关闭部落冲突查询。

2.4.20.开启漂流瓶

只有开启漂流瓶之后才可以使用漂流瓶相关指令。

2.4.21.关闭漂流瓶

关闭漂流瓶

2.4.22.开启游戏

开启游戏，开启后才可以使用2.6.RPG游戏。

2.4.23.关闭游戏

关闭RPG游戏

2.4.24.开启游戏限制模式

限制模式是一个特殊状态。当你开启了游戏同时开启了限制模式，那么成员只可以执行签到等指令无法刷屏。

但是如果你关闭了游戏，那么不论有没有开启限制模式，都无法使用游戏相关的功能。

2.4.25.关闭游戏限制模式

关闭游戏限制模式

2.4.26.开启智能回复

小柒偶尔会话痨，有$1\mathrm{\%}$$1\%$的概率回复你说的话。通过艾特可以让小柒强制回复。

2.4.27.关闭智能回复

如果你关闭了智能回复。那么2.4.26.开启智能回复描述的场景将不会发生。小柒不会对任何话做出类似于人的回复。

2.4.28.开启文摘

开启文摘后才可以使用文摘相关的功能。

2.4.29.关闭文摘

关闭文摘

2.4.30.开启脏话

开启脏话。参考：2.5.9.骂我。

2.4.31.关闭脏话

关闭脏话。

2.4.32.开启入群欢迎

当有新成员进入的时候就会发送该消息。

如果你需要重新设置入群欢迎，请直接使用该命令，就会覆盖原来的入群欢迎。

2.4.33.关闭入群欢迎

关闭入群欢迎

2.4.34.添加屏蔽词 [屏蔽词]

例如：添加一个屏蔽词 草。然后在群内发送包含“草”的消息都会被撤回。

当用户在群内发送屏蔽词的消息的时候，小柒会撤回目标消息

2.4.35.删除屏蔽词 [屏蔽词]

删除一个屏蔽词

2.4.36.禁言(时间) [@xxx]

例如：@成员1 @成员2 禁言二十分钟。成员1和成员2都会被禁言二十分钟。

这是一个复杂的指令，所有被艾特的人都会被禁言。如果小柒能够禁言的话。

时间由汉语描述。例如：三天十小时三十二分钟五十四秒。省略时间则默认十分钟，例如：@成员1 禁言。

时间的上限是三十天，下限为一分钟。

2.4.37.解除禁言 [@xxx]

参考上条命令，该命令可以解除禁言。

例如：@成员1 @成员2 解除禁言即可解除两人的禁言。

2.4.38.开启群回复共享

开启群回复共享。开启后其他群将可以复制本群的自定义群回复。参考：2.4.40.复制回复 [群号]

2.4.39.关闭群回复共享

关闭群回复共享

2.4.40.复制回复 [群号]

只有目标群开启了群回复共享才能够复制。参考2.4.38.开启群回复共享。请注意将会覆盖掉本群所有自定义回复、指令隧穿、屏蔽词，参考：2.4.41.添加回复、2.4.34.添加屏蔽词 [屏蔽词]。

2.4.41.添加回复 [触发词] [回复] (QQ号)

从这条指令开始我们将会讲一个非常强大的功能——调教自定义回复！

我们首先来看一个例子：

添加成功后，当用户发送触发词一模一样的内容将会触发回复。最后一个QQ号是可选参数。如果有代表需要艾特某个人。比如这里就艾特了一个人。如果没有表示不艾特。

1. 请注意回复是没有办法包含图片的，要包含图片可以使用：2.4.45.添加复杂回复。
2. 同一个触发词可以包含多个回复，不同回复将会随机选择。

2.4.42.删除回复 [触发词] [回复]

删除一对回复。

你心中是不是有疑惑，那我怎么记得我调教了什么？别急，下面马上告诉你。

2.4.43.查看回复 (页码)

页码从1开始，看每一页的回复。

例如：

你看我们刚刚添加的回复就在这里，并且下面还会告诉你有多少页。

2.4.44.清空回复

这可是个危险的指令。会直接清空所有的回复。请谨慎使用！

2.4.45.添加关键词 [触发词] [回复] (QQ号)

关键词与回复不同，回复需要和触发词一模一样，但是关键词只需要包含触发词就可以了

2.4.46.删除关键词 [触发词] [回复]

删除一对关键词

2.4.47.清空关键词

清空所有的关键词

2.4.48.查看关键词 (页码)

查看关键词

参考：2.4.43.查看回复 (页码)

2.4.49.添加复杂回复

复杂回复是一个特殊的存在，上面的回复都无法包含图片等丰富的元素，但是复杂回复可以。他可以包含图片表情等各种各样的消息。

只需要发送添加复杂回复小柒就会指引你完成复杂回复的创建。

注意：复杂回复一个触发词只可以包含一个回复，这点与前面两种是不同的。

2.4.50.删除复杂回复 [触发词]

删除对应的复杂回复

2.4.51.清空复杂回复

清空复杂回复

2.4.52.查看复杂回复 (页码)

查看对应的复杂回复

参考：2.4.43.查看回复 (页码)

2.4.53.添加指令隧穿 [原始指令] [目标指令]

这又是另一个高级用法。建议先把前面的添加回复看完之后再来学习这条指令。

例如指令2.5.1.硬币。你觉得硬币这个触发词很不好，你不喜欢。你就可以使用如下的命令添加指令隧穿 抛硬币 硬币。这样子所有的抛硬币也会被替换为硬币，就可以发送抛硬币来触发硬币这个功能。

原始指令将会被目标指令替代。

还有另一个高级用法：例如：硬币这个指令你非常不喜欢。你可以做出如下操作：

1. 添加回复 1 不要抛硬币了，信不信我揍你。
2. 添加指令隧穿 硬币 1

如此，每当你输入硬币的是时候都会回复不要抛硬币了，信不信我揍你。来达到屏蔽指令的目标。原理讲解：当硬币指令进来的时候就被替换为了1。而1又是个回复就可以激活回复的内容。当然你也看单纯地不加回复，就让这条指令失效。

2.4.54.删除指令隧穿 [原始指令] [目标指令]

删除一对指令隧穿

2.4.55.查看指令隧穿

查看所有的指令隧穿

2.4.56.添加定时消息

该指令可以添加一条定时消息。到达时间的时候该消息会自动发送。

2.4.57.查看定时消息(页码)

查看某一页的定时消息

2.4.58.删除定时消息 [名字]

通过名字去删除一条定时消息

2.4.59.清空定时消息

清空所有定时消息

2.5.基础功能

2.5.1.硬币

小柒将会帮你抛一枚硬币

2.5.2.骰子 / 色子

小柒将会帮你扔一个骰子

2.5.3.运势

小柒将会帮你占卜今天的运势

2.5.4.抽卡

如果小柒是群管理，并且你在群内发送该命令。你将会抽一张意想不到的卡片~！

2.5.5.扔漂流瓶 [内容]

请注意每一个漂流瓶都有日志记录，不要违反法律、不要打广告。违者将会全局黑名单。

把一个漂流瓶扔向大海。

使用前要注意本群是否有开启漂流瓶哦~通过模块列表查看。

2.5.6.捡漂流瓶

受到开启/关闭漂流瓶的影响

从大海内捡一个漂流瓶。

2.5.7.文摘

受到开启/关闭文摘的影响

返回一条文摘

2.5.8.情话

受到开启/关闭文摘的影响

返回一句情话

2.5.9.骂我

受到开启/关闭脏话的影响

让小柒骂你一句

2.5.10.舔狗日记

受到开启/关闭文摘的影响

舔狗日记

2.5.11.笑话

受到开启/关闭文摘的影响

返回一句笑话

2.5.12.鬼故事

受到开启/关闭文摘的影响

返回一个鬼故事

2.5.13.塔罗牌

2.6.RPG游戏

受到开启/关闭游戏的影响

2.6.1.指令部分

2.6.2.buff查询

2.6.3.附魔查询

2.7.部落冲突查询

受到开启/关闭部落冲突查询的影响

2.7.1.coc [兵种名字]

例如：coc 超级哥布林

小柒将会发送对应兵种的详细信息

2.7.2.coc商人

可以查看商人的刷新表

2.7.3.coc联赛奖励

可以查看不同联赛对应的奖章奖励

2.7.4.coc部落战奖励

可以查看部落战奖励机制

2.7.5.coc闪电机制

可以查看闪电的用法与机制

2.7.6.coc闪震计算表

可以查看闪震计算表。

2.7.7.coc夜世界奖励

可以查看夜世界奖励

2.7.8.coc援军等级限制

可以查看援军等级的限制

3.常见问题Q&A

3.1.小柒不在线了？

不在线有两种可能：封号冻结、连接丢失。

1. 封号冻结：这是经常发生的，可以参考3.2.如何预防封号冻结。
2. 连接丢失：这种情况发生的概率极低，建议先验证是否是被封号冻结了。如果真的是连接丢失请进入官方群联系重启。我们不建议机器人主人退出官方群，以免无法得到技术支持。

3.2.如何预防封号冻结

根据小柒运行一年的经验，我们发现了如下的规律：

1. 被人恶意举报，因为小柒的消息具有机器人的特征。很容易被人恶意举报。
2. 刷屏：尤其是RPG游戏部分，大量的打怪、挖矿极有可能导致腾讯风控小柒（具体表现为判定为热聊）。
3. 链接、图片：小柒拥有自定义回复的功能，如果有群利用该功能大量填充链接，让小柒发大量链接和图片就有可能封号。
4. XML卡片：大量发送分享卡片也可能导致封号，不过更大概率是风控。目前的xml卡片只有音乐这一个指令。
5. 不要异地登录，小柒的QQ号登录在服务器，如果你异地登录QQ号很容易被判定为风险行为，造成封号。

3.3.小柒在线但是不理我

发生该情况请按照以下步骤依次检查。

1. 是否被机器人主人/管理员拉入黑名单。黑名单每24小时会有一次提醒。可以用该命令确定自己是否在黑名单：机器人名字
2. 群是否在黑名单，这点很好判断，看群内其他人是否能够唤醒机器人就可以了。
3. 是否被风控了。风控的表现为：群聊私聊都无法回复。或者消息时断时续。时不时发几条消息，然后又不能发消息。
4. 局部风控：其他人都能正常使用小柒，群内就你一个人不能使用，该情况你只需要退出一下群然后重新进群就好了。是你自己的账号本身被tx风控了。
5. 未知bug：该情况发生的可能性极小，一般都是第三点的原因。发生该情况可以前往官方群寻求支持。

3.4.如何预防风控

预防风控和封号是一样的。但是风控最主要的原因是因为刷屏。

3.5.如果我想登录挂机器人的QQ怎么办

首选我们不推荐你登陆，如果你实在得登录继续往下看。

QQ的登陆协议分为：手表、手机、平板、电脑。四个协议可以同时在线，但是相同协议不能同时在线两个。例如：你可以同时登陆手机和电脑。但是不可以登陆两台手机。你还可以在登陆手机和电脑的同时去登陆平板。

小柒将会使用手机QQ协议来登陆QQ。所以你可以通过手表、平板、电脑三种方式登陆QQ。

平板登陆的时候一定要注意下载的应用名为：QQ HD。

很多应用商店同时存在：QQ和QQ HD。QQ HD版本才是平板的QQ。

3.6.如果不小心登陆了手机QQ小柒被挤下线了怎么办

进入官方群，联系重启。

3.7.被封号后如何解封？解封后如何重启机器人？

被封号后使用手机QQ，输入机器人的QQ号和密码登陆，然后会提升账号被冻结/封号。点击“去处理”然后按照步骤解封即可。

目前重启还只能联系官方群，后续会陆续推出网页重启。

解封后一定要联系重启机器人。